Casos Boletín Comercial

Este endpoint permite extraer la información de boletines comerciales asociada a un RUT previamente cargado en tu cuenta de Sheriff.

• No se generará ningún costo adicional al consultar información de un RUT ya cargado en la plataforma.
• Asegúrate de que el RUT esté pre-cargado en la plataforma antes de intentar extraer su información.

Detalle de API

Request

• URL: /helper/boletin/{rut}/boletinComercial
• Método: GET

Parámetros

• rut (requerido): El RUT del cual se desea extraer la información. Formato del rut "12345678-9".

Ejemplo request con curl

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/clients/v2/helper/boletin/12345678-9/boletinComercial'\
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
  -H 'x-client-identifier: SheriffSecureClient-v1'

Response

Success

• Status code: 200

• Example response body:

  {
    "success": true,
    "data": {
      "cantidad": {
        "Bolcom": 1,
        "InfoCom": 1
      },
      "casos": {
        "Bolcom": [
          {
            "nombre": "Empresa 1",
            "tipoDescripcion": "Detalle BIC",
            "codigoEmisor": "00",
            "emisor": "Emisor 1",
            "nombreLibrador": "",
            "montoDeuda": 10000,
            "fechaPublicacion": "24-11-2025",
            "fechaProtesto": "24-11-2025",
            "fechaVencimiento": null,
            "localidadPublicacion": "Santiago",
            "nroBoletin": 123456,
            "nroOperacion": null,
            "pagBoletin": 1,
            "tipoCredito": null,
            "tipoDocumento": "CH",
            "tipoDocumentoImpago": "FF",
            "tipoEmisor": "BCO",
            "glosaCortaMoneda": "$",
            "glosatipoMoneda": null,
            "glosaTipoDocumento": "Cheque",
            "glosaTipoDocumentoImpago": "FALTA DE FONDOS",
            "glosaTipoEmisor": "Bancos",
            "glosaTipoCredito": null,
            "nombreAcreedor": null
          }
        ],
        "InfoCom": [
          {
            "nombre": "Empresa 2",
            "tipoDescripcion": "Detalle MOL",
            "codigoEmisor": "00",
            "emisor": "Emisor 2",
            "nombreLibrador": "",
            "montoDeuda": 10000,
            "fechaPublicacion": "24-11-2025",
            "fechaProtesto": "24-11-2025",
            "fechaVencimiento": null,
            "localidadPublicacion": "Santiago",
            "nroBoletin": 123456,
            "nroOperacion": null,
            "pagBoletin": 1,
            "tipoCredito": null,
            "tipoDocumento": "CH",
            "tipoDocumentoImpago": "FF",
            "tipoEmisor": "BCO",
            "glosaCortaMoneda": "$",
            "glosatipoMoneda": null,
            "glosaTipoDocumento": "Cheque",
            "glosaTipoDocumentoImpago": "FALTA DE FONDOS",
            "glosaTipoEmisor": "Bancos",
            "glosaTipoCredito": null,
            "nombreAcreedor": null
          }
        ]
      }
    }
  }

  A continuación se describen los campos devueltos en la respuesta JSON.

  Campo	Tipo	Descripción
  success	bool	Indica si la operación fue exitosa.
  data	object	Objeto que contiene conteos por fuente en cantidad y los casos agrupados por fuente.

  Campos dentro de data:

  Campo	Tipo	Descripción
  cantidad	object	Objeto con conteos por fuente. Ej: { "Bolcom": 1, "InfoCom": 1 }.
  casos	object	Objeto que agrupa arrays de casos por fuente. Ej: { "Bolcom": [...], "InfoCom": [...] }.

  Estructura de cada objeto dentro de casos:

  Campo	Tipo	Descripción
  nombre	string	Nombre asociado al caso (empresa o persona).
  tipoDescripcion	string	Descripción del tipo de boletín (ej: "Detalle BIC").
  codigoEmisor	string	Código del emisor
  emisor	string	Nombre del emisor.
  nombreLibrador	string	Nombre del librador o girador (puede ser cadena vacía).
  montoDeuda	number	Monto de la deuda en moneda local (ej: 10000).
  fechaPublicacion	string	Fecha de publicación.
  fechaProtesto	string	Fecha de protesto si aplica.
  fechaVencimiento	string	Fecha de vencimiento o null si no aplica.
  localidadPublicacion	string	Localidad donde se publicó el boletín.
  nroBoletin	number	Número de boletín (puede incluir ceros a la izquierda en origen).
  nroOperacion	number	Número de operación o null si no disponible.
  pagBoletin	number	Página del boletín (si aplica).
  tipoCredito	string	Tipo de crédito o null si no aplica.
  tipoDocumento	string	Código del tipo de documento (ej: "CH").
  tipoDocumentoImpago	string	Código del tipo de impago (ej: "FF").
  tipoEmisor	string	Código del tipo de emisor (ej: "BCO").
  glosaCortaMoneda	string	Símbolo o abreviatura de moneda (ej: "$" ).
  glosatipoMoneda	string	Texto descriptivo de la moneda o null.
  glosaTipoDocumento	string	Texto de glosa para el tipo de documento (ej: "Cheque").
  glosaTipoDocumentoImpago	string	Texto de glosa para el tipo de impago (ej: "FALTA DE FONDOS").
  glosaTipoEmisor	string	Texto de glosa para el tipo de emisor (ej: "Bancos").
  glosaTipoCredito	string	Glosa del tipo de crédito o null si no aplica.
  nombreAcreedor	string	Nombre del acreedor o null si no disponible.

  Nota: Los campos marcados como "No" pueden no estar presentes o ser null según disponibilidad de datos en la fuente.

  Glosario de Términos

  Para una referencia completa consulta el Glosario de Términos. En particular, revisa las definiciones de tipoDocumento, tipoDocumentoImpago, tipoEmisor, y otros términos relevantes para los boletines comerciales.

  Errores

  400 - Solicitud inválida

  {
    "success": false,
    "code": 400,
    "error": "Solicitud inválida"
  }

  401 - No autorizado

  {
    "success": false,
    "code": 401,
    "error": "No autorizado"
  }

  403 - No tienes permiso para acceder a este recurso

  {
    "success": false,
    "code": 403,
    "error": "No tienes permiso para acceder a este recurso"
  }

  404 - Recurso no encontrado

  {
    "success": false,
    "code": 404,
    "error": "Recurso no encontrado"
  }

  408 - Tiempo de espera agotado

  {
    "success": false,
    "code": 408,
    "error": "Tiempo de espera agotado"
  }

  429 - Demasiadas solicitudes

  {
    "success": false,
    "code": 429,
    "error": "Demasiadas solicitudes"
  }

  500 - Error interno del servidor

  {
    "success": false,
    "code": 500,
    "error": "Error interno del servidor"
  }